                      


To play pokemon red just click on the file that says pokemon red





			 =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=               
                             K.G.B.  version 0.20
                            written by Matt Currie
                               mattc@ihug.co.nz
                        http://kgb.emulationworld.com
                       =-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=

0.0  New to this release
=-=-=-=-=-=-=-=-=-=-=-=-
-directory where roms are found can be changed
-options are saved
-SNES Pro! support
-Super Gameboy support
-Classic Gameboy always has blurry mode on (if you don't like it.. well.. :p)
-Super Gameboy always has scanlines (if you don't like it.. well.. :p)
-added 256x256x256 colour screen resolution
-added 640x480x32768 colour screen resolution (in preparation for GBColor)
-removed all other screen resolutions (may add some back later)
-new GUI with mouse support
-fixed numerous bugs in emulation.. still more to come.
-lots more bugs to fuck everything up..

1.0  What is it?
=-=-=-=-=-=-=-=-

It's a Nintendo Gameboy (tm) emulator for DOS (and eventually Windows).
The CPU emulation and most of the screen emulation is written in 32-bit
assembly and the wrapper is in Delphi.  To run Delphi code under DOS I'm
using WDosX v0.95 (sr1) by Michael Tippach which includes Win32 emulation
for under DOS.

You're probably gonna want to have a pentium of some description to run
it well.  There was frame skipping but that was causing problems on slow
computers when SuperGameboy was enabled so it is removed, sorry.  There
is however slow down for fast PCs (like mine when I get my upgrade).


2.0  Record of updates
=-=-=-=-=-=-=-=-=-=-=-

0.20  99/03/18:   -second public release

0.10  98/06/08:   -first public release


3.0  How to use it
=-=-=-=-=-=-=-=-=-

To use KGB you obviously need some gameboy roms.  These can be obtained
by downloading them from carts you own, or if you don't have access to a
reader/writer you can probably find the roms to the carts you own on the
net somewhere.  Don't ask me where, I won't tell you. 

Copy KGB into the directory where your roms are or specify a roms directory
by editing the kgb.cfg file.  

All the following options are accessable from the GUI (except setting of the
rom directory, to set this either use the commandline or edit the kgb.cfg
file). 


   usage:  kgb.exe [/v?] [/c1?] [/c2?] game.gb

	/v?   :   select from the different video modes:
                        0  :  hires - games play in 640x480x32768 colour mode.
                        1  :  lores - games play in 256x256x256 colour mode.

	/r[directory]	:	set directory where your gameboy roms are
				stored (saves will be stored here also).

	/c1?   :   selects a controller for gameboy 1.
	/c2?   :   selects a controller for gameboy 2.
			0 - keyboard 1 (default for player 1)
			1 - keyboard 2 (default for player 2)
                        2 - SNES Pro! on LPT1
                        3 - SNES Pro! on LPT2 (see below for info)


When KGB starts up, if you specified a game to run, it will begin the
emulation immediately, if not, it will come up with the main menu.

3.1 Controllers
---------------

The gameboy emulation may be controlled with any of the following:

Keyboard 1
        UP              up
        DOWN            down
        LEFT            left
        RIGHT           right
        B               a
        A               s
        Select          d
        Start           f
Keyboard 2
        UP              i
        DOWN            k
        LEFT            j
        RIGHT           l
        B               7
        A               8
        Select          9
        Start           0
Snes Pro! LPT1
        guess
Snes Pro! LPT2
        guess

These can be selected from the controllers menu.

In the emulation, ESC and SPACE can be used to access the menu.

3.11 Snes Pro!
--------------

This is basically a SNES controller hooked up to one of your parallel ports
and a joystick port (for power).  How to wire one up is below: (provided by
MegaMan_X)


 SNES Gamepad (Model No. SNS-005)
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

	Parallel                Gamepad                Original GamePad
	  Port                                           wires colors
				 Ŀ
	 Ŀ          Ĵ 1  +5Vcc           White
   Data0  02 ĳĴ 2  Clk             Yellow
   Data1  03 ĳĴ 3  Reset           Orange
   Ack    10 ĳĴ 4  Data In 1       Red
	                      Ĵ
	                       5  Data In 2       *Not connected*
	                       6  Data In 3       *Not connected*
   GND    18 ĳĴ 7  GND             Brown
           Ĵ               \_/
   GND    25          
	                      Note:
			            This is the same pinout used by
      PC Game Port                  the TSR program "SNES Pro!".
	 Ŀ            
     +5V  1             = connected
     GND  4 
	                         ĳ = not connected

NOTE: before you build one take note that I take no responsability for any
damages inflicted in the building or use of this device.

That said, this is how I connected my SNES controller and it works just
nicely.  SNES controllers are particularly good for Gameboy because they
have Start and Select buttons and the A and B buttons are arranged the same
as on the Gameboy.  It also adds to the realism when in Super Gameboy mode.
Yay :)


4.0 Status/Future
=-=-=-=-=-=-=-=-=

4.1 What's done
---------------
- CPU emulation
- Screen emulation
- MBC1, MBC2, MBC3 emulation
- Battery backed-up RAM
- Blurry LCD gameboy screen
- GUI
- Speed throttling
- GameGenie (tm) cheats (not added to gui yet, so you can't use em :)
- SnesPro controller support
- Super Gameboy support
- Sound (fucked up.. so there's none there and i'm redoing this)
- Various things.

4.2 What's not done but might be done if you hold your breath long enuf
-----------------------------------------------------------------------
- Joystick support
- Instant save/load - i'm delaying this until SGB emulation is finished
  so as to avoid problems of incompatibility in the save files.
- GB-GB Mode - two GB's emulated and linked up (it's getting close, i've had
  a few games running alright)
- Colour Gameboy support..
- The Windows 95 port.

4.3 Bugs
--------
Well, there's got to be quite a few in the emulation cos compatability
isn't great, to say the least.

There may also be lots of random crashes as this version isnt _quite_ as
stable as I would have hoped.. yet.. I'll fix it when I get my upgrade which
won't have a screwed cpu.


5.0 Thanks
=-=-=-=-=-

Thanks to basically everyone who has done anything to do with the gameboy,
cos I've probably used it in writing the emulator or testing it or whatever.

Also, thanks to everyone who has emailed me since the release.  It's really
good to know that people are interested, etc.

A special thanks to Jim Geffre and Anders Granlund for all their help.

Thanks to all the other people who helped.. i'll add them when I'm not
about to fall asleep..


6.0 Legal, cover my ass type stuff
=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-=-
-You get what you pay for and since I've charged you nothing I don't owe you
jack.
-I am in no way at all whatsoever affiliated with Nintendo of America,
of Japan, or anywhere in fact.
-Gameboy is a registered trademark of Nintendo Co., Ltd.
-The Nintendo logo displayed is not stored in my program but in the rom image
being provided by the user.  It is extracted and displayed as in the real
Gameboy.
-If this program damages you, your computer, your dog, your life, your
wife or anything related to you or your existance then you agree not to hold
me liable, by running this program you agree to this statement.
-You may distribute this version of the program freely as long as you do not
include any Gameboy rom images with the distribution, this includes being on
CD-ROMs or similar.
-I do NOT encourage the pirating of Gameboy games.
-All trademarks mentioned are trademarks of their respective companies and
used for identification purposes only.
-This program is not licensed for use in commercial applications, if you
require it contact me for arrangements.

Thank you and good night!

